Предыдущая | Следующая | Оглавление

function

Доступность

Flash Player 5.

Синтаксис

function functionname ([parameter0, parameter1,...parameterN]){
  statement(s)
}
function ([parameter0, parameter1,...parameterN]){
  statement(s)
}

Параметры

functionname Имя новой функции. Этот параметр необязателен.

parameter Идентификатор, представляющий передаваемый функции параметр. Этот параметр необязателен.

statement(s) Любые инструкции ActionScript, которые вы определили в качестве тела function.

Возвращает

Случай использования 1: Ничего.

Случай использования 2: Ссылку на безымянную функцию.

Описание

Выражение; содержит набор задаваемых вами выражений, для выполнения определенных задач. Вы можете задать функцию в одном месте и запускать или вызывать (call) ее из различных скриптов в файле SWF. Когда вы определяете функцию, вы также можете указать для нее параметры. Параметры являются метками-заполнителями для значений, над которыми оперирует функция. Вы можете отправлять функции различные параметры всякий раз во время ее вызова, таким образом, вы можете повторно ее испоьзовать в различных ситуациях.

Используйте выражение return в statement(s) для того, чтобы функция генерировала или возвращала (return) значение.

Вы можете использовать это выражение для определения function с заданными functionname, parameters, и statement(s). Во время вызова функции выполняются определяемые в ней выражения. Опережающие ссылки допускаются; в пределах одного скрипта, функция может быть объявлена после того, как вызывалась. Определение функции замещает любое ранее сделанное определение для этой же функции. Вы можете использовать этот синтаксис везде, где выражение допустимо.

Вы также можете использовать это выражение для создания безымянной функции и получения ссылки на нее. Этот синтаксис используется в выражениях и особенно полезен для установки методов в объектах.

Для большей функциональности вы может использовать arguments object при определении вашей функции. Обычно arguments object используется для создания функции, которая принимает переменное число параметров и для создания безымянных рекурсивных функций.

Пример

Следующий пример определяет функцию sqr, которая принимает один параметр и возвращает Math.pow(x, 2) этого параметра:

function sqr(x:Number) {
  return Math.pow(x, 2);
}
var y:Number = sqr(3);
trace(y);  // в окне output: 9

Если функция определяется и используется в том же скрипте, то определение функции может происходить после ее использования:

var y:Number = sqr(3);
trace(y);  // в окне output: 9
function sqr(x:Number) {
  return Math.pow(x, 2);
}

Следующая функция создает объект LoadVars и загружает params.txt в файл SWF. Когда файл успешно загрузится, то выводится сообщение переменные загружены:

var myLV:LoadVars = new LoadVars();
myLV.load("params.txt");
myLV.onLoad = function(success:Boolean) {
  trace("переменные загружены");
}

Посмотреть комментарии LiveDocs		Предыдущая | Следующая | Оглавление